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这 份 文档 是 Google Java 编 程 风 格 规 范 的 完整 定义 。 当 且 仅 当 一 个 Java 源 文件 符合 此 文档 中 的 
规则 ， 我 们 才 认 为 它 符合 Google 的 Java 编 程 风格 。 

与 其 它 的 编程 风格 指南 一 样 ， 这 里 所 讨论 的 不 仅仅 是 编码 格式 美 不 美 观 的 问题 ， 同时 也 讨论 
一 些 约定 及 编码 标准 。 然 而 ， 这 份 文档 主要 侧重 于 我 们 所 普通 遵 循 的 规则 ， 对 于 那些 不 是 明 
人 确 强制 要 求 的 ， 我 们 尽量 避免 提供 意见 。 


1.1 术语 说 明 
在 本 文档 中 ， 除 非 另 有 说 明 : 


1. 术语 class 可 表示 一 个 普通 类 ， 枚 举 类 ， 接口 或 是 annotation 类 型 ( @interface ) 
2. 术语 comment 只 用 来 指 代 实 现 的 注释 (implementation comments)， 我 们 不 使 
用 “documentation comments "一 词 ， 而 是 用 Javadoc。 


其 他 的 术语 说 明 会 偶尔 在 后 面 的 文档 出 现 。 


1.2 指南 说 明 


本 文档 中 的 示例 代码 并 不 作为 规范 。 也 就 是 说 ， 虽 然 示例 代码 是 遵循 Google 编 程 风 格 ， 但 并 
不 意味 着 这 是 展现 这 些 代码 的 唯一 方式 。 示例 中 的 格式 选择 不 应 该 被 强制 定 为 规则 。 


源 文 件 基础 


2.1 文件 名 


源 文件 以 其 最 顶层 的 类 名 来 命名 ， 大 小 写 敏感 ， 文 件 扩展 名 为 .java 。 


2.2 文件 编码 : UTF-8 


源 文件 编码 格式 为 UTF-8。 


2.3 特殊 字符 


2.3.1 空白 字符 


除了 行 结束 符 序列 ，ASCII 水 平 空格 字符 (0x20， 即 空格 ) 是 源 文件 中 唯一 允许 出 现 的 空白 字 
符 ， 这 意味 着 : 


1. 所 有 其 它 字 符 串 中 的 空白 字符 都 要 进行 转 义 。 
2， 制 表 符 不 用 于 缩 进 。 


2.3.2 特殊 转 义 序列 


对 于 具有 特殊 转 义 序列 的 任何 字符 (\b, \t, \n, W, \ \, \ 及 )， 我 们 使 用 它 的 转 义 序列 ， 而 不 是 相 
应 的 八进制 (比如 1012 ) 或 Unicode( 比 如 \uoooa ) 转 义 。 


2.3.3 非 ASCIl 字 符 


对 于 剩余 的 非 ASCIl 字 符 ， 是 使 用 实际 的 Unicode 字 符 (比如 )， 还 是 使 用 等 价 的 Unicode 转 义 
符 (比如 \u221e)， 取 决 于 哪个 能 让 代码 更 易于 阅读 和 理解 。 


Tip: 在 使 用 Unicode 转 义 符 或 是 一 些 实际 的 Unicode 字 符 时 ， 建 议 做 些 注 释 给 出 解 
这 有 助 于 别人 阅读 和 理解 。 


FE, 
例如 : 


String 
String 
String 
String 
return 


ss 


unitAbbrev 
unitAbbrev 
unitAbbrev 
unitAbbrev 
'\ufeff' + 


= "us"; 

= "\u03bcs"; // "us" 

= "\u03bcs"; // Greek letter mu, 
= "\u03bcs"; 

content; // byte order mark 


ugu 


w, MESE TAIE 

允许， 但 没有 理由 要 这 样 做 

人 允许， 但 这 样 做 显得 笨拙 还 容易 出 错 
很 糟 ， 读 者 根本 看 不 出 这 是 什么 
Good， 对 于 非 打 印字 符 ， 使 用 转 义 ， 并 





Tip: 永远 不 要 由 于 害怕 某 些 程序 可 能 无 法 正确 处 理 非 ASCII 字 符 而 让 你 的 代码 可 读 性 
变 差 。 当 程序 无 法 正确 处 理 非 ASCIIl 字 符 时 ， 它 自然 无 法 正确 运行 ， 你 就 会 去 fix 这 
些 问题 的 了 。( 言 下 之 意 就 是 大 胆 去 用 非 ASCII 字 符 ， 如 果真 的 有 需要 的 话 ) 


源 文件 结构 


一 个 源 文件 包含 ( 按 顺 序 地 ) : 


许可 证 或 版 权 信息 (如 有 需要 ) 
package 语 名 

import 语 名 

一 个 顶级 类 (只 有 一 个 ) 


上 Nm 一 


以 上 每 个 部 分 之 间 用 一 个 空 行 隔 开 。 


3.1 许可 证 或 版 权 信息 


如 果 一 个 文件 包含 许可 证 或 版 权 信 息 ， 那 么 它 应 当 被 放 在 文件 最 前 面 。 


3.2 package} 4) 


package 语 句 不 换行 ， 列 限制 (4.4 节 ) 并 不 适用 于 package 语 句 。( 即 package 语 句 写 在 一 行 里 ) 


3.3 import;3 4) 


3.3.1 import 不 要 使 用 通配符 


即 ， 不 要 出 现 类 似 这 样 的 import 语 句 : import java.util.*; 


3.3.2 不 要 换行 


import 语 名 不 换行 ， 列 限制 (4.4 节 ) 并 不 适用 于 import 语 句 。( 每 个 Import 语句 独立 成 行 ) 


3.3.3 顺序 和 间距 
import 语 名 可 分 为 以 下 几 组 ， 按 照 这 个 顺序 ， 每 组 由 一 个 空 行 分 隔 : 


1. 所 有 的 静态 导入 独立 成 组 

2 com.google imports(/x Y 这 个 源 文件 是 在 com.google 包 下 ) 

3. 第 三 方 的 包 。 每 个 顶级 包 为 一 组 ， 字 典 序 。 例 如 : android, com, junit, org, sun 
4. java imports 

5. javax imports 


组 内 不 空 行 ， 按 字典 序 排列 。 


3.4.1 只 有 一 个 顶级 类 声明 
每 个 项 级 类 都 在 一 个 与 它 同名 的 源 文件 中 (当然 ， 还 包含 java EA) 


例外 : package-info.java , 该 文件 中 可 没有 package-info 类 。 


3.4.2 类 成 员 顺 序 

类 的 成 员 顺 序 对 易学 性 有 很 大 的 影响 ， 但 这 也 不 存在 唯一 的 通用 法 则 。 不 同 的 类 对 成 员 的 排 
序 可 能 是 不 同 的 。 最 重要 的 一 点 ， 每 个 类 应 该 以 某 种 退 辑 去 排序 它 的 成 员 ， 维 护 者 应 该 要 能 
MARA. TEO, 新 的 方法 不 能 总 是 习惯 性 地 添加 到 类 的 结尾 ， 因 为 这 样 就 是 按时 
间 顺 序 而 非 某 种 逻辑 来 排序 的 。 


3.4.2.1 EX: 永 不 分 离 


当 一 个 类 有 多 个 构造 画 数 ， 或 是 多 个 同名 方法 ， 这 些 画 数 /方法 应 该 按 顺 序 出 现在 一 起 ， 中 间 
不 要 放 进 其 它 函 数 /方法 。 


格式 


术语 说 明 : 块 状 结构 (block-like construct) 指 的 是 一 个 类 ， 方 法 或 构造 画 数 的 主体 。 需 要 注意 
的 是 ， 数 组 初始 化 中 的 初始 值 可 被 选择 性 地 视 为 块 状 结构 (4.8.3.1 节 )。 


4.1 大 括号 


4.1.1 使 用 大 括号 (即使 是 可 选 的 ) 


大 括号 与 if，else，for，do，while 语句 一 起 使 用 ， 即 使 只 有 一 条 语句 (或 是 空 )， 也 应 该 把 大 
括号 写 上 。 


4.1.2 JFZ} : K&R 风格 


对 于 非 空 块 和 块 状 结构 ， 大 括号 遵循 Kernighan 和 Ritchie 风 格 (Egyptian brackets): 


e 左 大 括号 前 不 换行 

e 左 大 括号 后 换行 

e 右 大 括号 前 换行 

。 如 果 右 大 括号 是 一 个 语句 、 画 数 体 或 类 的 终止 ， 则 右 大 括号 后 换行 ; 否则 不 换行 。 例 如 ， 
如 果 右 大 括号 后 面 是 else 或 喜 号 ， 则 不 换行 。 


示例 : 


return new MyClass() { 
@Override public void method() { 
if (condition()) { 
try { 
something(); 
y catch (ProblemException e) { 
recover(); 
} 
} 
} 
J; 


4.8.1 节 给 出 了 enum 类 的 一 些 例外 。 


4.1.3 空 块 : 可 以 用 简洁 版 本 


一 个 空 的 块 状 结构 里 什么 也 不 包含 ， 大 括号 可 以 简洁 地 写成 {} ， 不 需要 换行 。 例 外 : MRE 


是 一 个 多 块 语句 的 一 部 分 (if/else 或 try/catch/finally) ， 即 使 大 括号 内 没 内 容 ， 右 大 括号 也 要 换 
行 。 


示例 : 


void doNothing() {} 


4.2 块 缩 进 : 2 个 空格 


每 当 开 始 一 个 新 的 块 ， 缩 进 增加 2 个 空格 ， 当 块 结束 时 ， 缩 进 返 回 先前 的 缩 进 级 别 。 缩 进 级 别 
适用 于 代码 和 注释 。( 见 4.1.2 节 中 的 代码 示例 ) 


4.3 一 行 一 个 语句 


每 个 语句 后 要 换行 。 


4.4 列 限制 : 805100 


一 个 项 目 可 以 选择 一 行 80 个 字符 或 100 个 字符 的 列 限制 ， 除 了 下 述 例外 ， 任 何 一 行 如 果 超 过 这 
个 字符 数 限 制 ， 必 须 自 动 换 行 。 

例外 : 

1. 不 可 能 满足 列 限制 的 行 (例如 ，Javadoc 中 的 一 个 长 URL， 或 是 一 个 长 的 JSNI 方 法 参考 )。 


2. package 和 import 语句 ( 见 3.2 节 和 3.3 节 )。 
3. 注释 中 那些 可 能 被 剪 切 并 粘贴 到 shell 中 的 命令 行 。 


4.5 目 动 换行 


术语 说 明 : 一 般 情 况 下 ， 一 行 基 代码 为 了 避免 超出 列 限制 (80 或 100 个 字符 ) 而 被 分 为 多 行 ， 我 
们 称 之 为 自动 换行 (line-wrapping)。 


我 们 并 没有 全 面 ， 确 定性 的 准则 来 决定 在 每 一 种 情况 下 如 何 自动 换行 。 很 多 时 候 ， 对 于 同一 
段 代码 会 有 好 几 种 有 效 的 自动 换行 方式 。 











Tip: 提取 方法 或 局 部 变量 可 以 在 不 换行 的 情况 下 解决 代码 过 长 的 问题 (是 合理 缩短 命 
名 长 度 吧 ) 


4.5.1 从 哪里 断 开 
自动 换行 的 基本 准则 是 : 更 倾向 于 在 更 高 的 语法 级 别处 断 开 。 


1， 如 果 在 非 赋值 运算 符 处 断 开 ， 那 么 在 该 符号 前 断 开 (比如 +， 它 将 位 于 下 一 行 )。 注 意 : 这 一 
点 与 Google 其 它 语 言 的 编程 风格 不 同 (如 C++ 和 JavaScript)。 这 条 规则 也 适用 于 以 下 “类 
运算 符 " 符 号 : 点 分 隔 符 (.)， 类 型 界限 中 的 & ( <T extends Foo & Bar> )，catch 块 中 的 管 
道 符 号 ( catch (FooException | BarException e ) 

2. 如果 在 赋值 去 算 符 处 断 开 ， 通 常 的 做 法 是 在 该 符号 后 断 开 (比如 =， 它 与 前 面 的 内 容留 在 同 
一 行 )。 这 条 规则 也 适用 于 foreach 语句 中 的 分 号 。 

3. 方法 名 或 构造 本 数 名 与 左 括号 留 在 同一 行 。 

4. 去 号 (,) 与 其 前 面 的 内 容留 在 同一 行 。 


4.5.2 自动 换行 时 缩 进 至 少 +4 个 空格 


自动 换行 时 ， 第 一 行 后 的 每 一 行 至 少 比 第 一 行 多 缩 进 4 
2.3.1 节 )。 


> 


空格 (注意 : 制 表 符 不 用 于 缩 进 。 见 


当 存 在 连续 自动 换行 时 ， 缩 进 可 能 会 多 缩 进 不 只 4 个 空格 (语法 元 素 存在 多 级 时 )。 一 般 而 言 ， 
两 个 连续 行使 用 相同 的 缩 进 当 且 仅 当 它 们 开始 于 同 级 语法 元 素 。 


第 4.6.3 水 平 对 齐 一 节 中 指出 ， 不 鼓励 使 用 可 变数 目的 空格 来 对 齐 前 面 行 的 符号 。 


4.6.1 垂直 空白 


以 下 情况 需要 使 用 一 个 空 行 : 


1. 


.在 责 数 体内 ， 语 句 的 逻辑 分 组 间 使 
， 类 内 的 第 一 个 成 员 前 或 最 后 一 个 成 员 后 的 空 行 


类 内 连续 的 成 员 之 间 : 字段 
块 。 


o 例外 : 两 个 连续 字段 之 间 的 空 行 是 可 选 的 ， 


辑 分 组 。 
用 空 行 。 


人 喜好 而 定 )。 


MERA, HA, RES, PSAE, KADRE 


用 于 字段 的 空 行 主要 用 来 对 字段 进行 远 


是 可 选 的 ( 既 不 鼓励 也 不 反对 这 样 做 ， 视 个 


.要 满足 本 文档 中 其 他 节 的 空 行 要 求 (比如 3.3 节 : import 语 句 ) 


多 个 连续 的 空 行 是 允许 的 ， 但 没有 必要 这 样 做 (我 们 也 不 鼓励 这 样 做 )。 


4.6.2 KFZ A 


除了 语言 需求 和 其 它 规则 ， 并 且 除 了 文字 ， 注 释 和 Javadoc 用 到 单个 空格 ， 


出 现在 以 下 几 个 地 方 : 


1. 
2. 


分 隔 任何 保留 字 和 与 紧 随 其 后 的 左 括号 ( ( )( 如 if, for catch 等 )。 
分 隔 任何 保留 字 与 其 前 面 的 右 大 括号 ( } )( 如 else, catch )。 


3. 在 任何 左 大 括号 前 ( { )， 两 个 例外 : 


o  (SomeAnnotation((a, b)) (不 使 用 空格 )。 
o string[][] x = foo; (大 括号 间 没 有 空格 ， 见 下 面 的 Note)。 
在 任何 二 元 或 三 元 运算 符 的 两 侧 。 这 也 适用 于 以 下 “类 运算 符 " 符 号 : 
o 类 型 界限 中 的 &( <T extends Foo & Bar> )。 
o catch 块 中 的 管道 符号 ( catch (FooException | BarException e )。 
o foreach 语句 中 的 分 号 。 
在 ，: ; 及 右 括号 ( ) ) 后 


单个 ASCII 空 格 也 


如 果 在 一 条 语句 后 做 注释 ， 则 双 斜 杠 (/) 两 边 都 要 空格 。 这 里 可 以 允许 多 个 空格 ， 但 没 


必要 。 
类 型 和 变量 之 间 : List list。 


数组 初始 化 中 ， 大 括号 内 的 空格 是 可 选 的 ， 即 new int[] {5, 6} 和 new int[] {5, 6 


} 都 是 可 以 的 。 








Note : 这 个 规则 并 不 要 求 或 禁止 一 行 的 开关 或 结尾 需要 额外 的 空格 ， 





做 要 求 。 


只 对 内 部 空格 


4.6.3 水 平 对 齐 : 不 做 要 求 


术语 说 明 : 水 平 对 齐 指 的 是 通过 增加 可 变数 量 的 空格 来 使 某 一 行 的 字符 与 上 一 行 的 相应 字符 


对 齐 。 


这 是 允许 的 (而 且 在 不 少 地 方 可 以 看 到 这 样 的 代码 )， 但 Google 编 程 风格 对 此 不 做 要 求 。 即 使 对 
于 已 经 使 用 水 平 对 齐 的 代码 ， 我 们 也 不 需要 去 保持 这 种 风格 。 


以 下 示例 先 展示 未 对 齐 的 代码 ， 然 后 是 对 齐 的 代码 : 


private int x; // this is fine 
private Color color; // this too 


private int Xx; // permitted, but future edits 
private Color color; // may leave it unaligned 


Tip: 对 齐 可 增加 代码 可 读 性 ， 但 它 为 日 后 的 维护 带 来 问题 。 考 虑 未 来 某 个 时 候 ， 我 
们 需要 修改 一 堆 对 齐 的 代码 中 的 一 行 。 这 可 能 导致 原本 很 漂亮 的 对 齐 代码 变 得 错 
位 。 很 可 能 它 会 提示 你 调整 周围 代码 的 空白 来 使 这 一 堆 代 码 重新 水 平 对 齐 (比如 程序 
员 想 保持 这 种 水 平 对 齐 的 风格 )， 这 就 会 让 你 做 许多 的 无 用 功 ， 增 加 了 reviewer 的 工 
作 并 且 可 能 导致 更 多 的 合并 冲突 。 


4.7 用 小 括号 来 限定 组 : 推荐 


除非 作者 和 reviewer 都 认为 去 掉 小 括号 也 不 会 使 代码 被 误解 ， 或 是 去 掉 小 括号 能 让 代码 更 易于 
阅读 ， 否 则 我 们 不 应 该 去 掉 小 括号 。 我 们 没有 理由 假设 读者 能 记 住 整个 Java 运 算 符 优先 级 
Ko 


4.8 具体 结构 


4.8.1 枚 举 类 
Mena BES IRA, RITO 
没有 方法 和 文档 的 枚 举 类 可 写成 数组 初始 化 的 格式 : 


private enum Suit { CLUBS, HEARTS, SPADES, DIAMONDS } 


由 于 枚 举 类 也 是 一 个 类 ， 因 此 所 有 适用 于 其 它 类 的 格式 规则 也 适用 于 枚 举 类 。 


4.8.2 % ÆA BH 

4.8.2.1 每 次 只 声明 一 个 变量 

不 要 使 用 组 合 声明 ， 比 如 int a, b; o 
4.8.2.2 需要 时 才 声 明 ， 并 尽快 进行 初始 化 


不 要 在 一 个 代码 块 的 开头 把 局 部 变量 一 次 性 都 声明 了 (这 是 c 语 言 的 做 法 )， 而 是 在 第 一 次 需要 
使 用 它 时 才 声 明 。 局 部 变量 在 声明 时 最 好 就 进行 初始 化 ， 或 者 声明 后 尽快 进行 初始 化 。 


4.8.3 数组 


4.8.3.1 数组 初始 化 : 可 写成 块 状 结构 
数组 初始 化 可 以 写成 块 状 结构 ， 比 如 ， 下 面 的 写法 都 是 OK 的 : 


new int[] { 
OO ES 
} 


new int[] { 
0, 


1, 
2, 
3 
} 
new int[] { 
(0 
23 
} 
new int[] 
fo, 1, 2, 3) 


4.8.3.2 非 C 风 格 的 数组 声明 


中 括号 是 类 型 的 一 部 分 : String[] args , 而 非 String args[] 。 


4.8.4 switch;¿ 4) 


术语 说 明 : switch 块 的 大 括号 内 是 一 个 或 多 个 语句 组 。 每 个 语句 组 包含 一 个 或 多 个 switch 标 签 
( case FOO: 或 default: )， 后 面 跟着 一 条 或 多 条 语句 。 


4.8.4.1 缩 进 

与 其 它 块 状 结构 一 致 ，switch 块 中 的 内 容 缩 进 为 2 个 空格 。 

每 个 switch 标 签 后 新 起 一 行 ， 再 缩 进 2 个 空格 ， 写 下 一 条 或 多 条 语句 。 
4.8.4.2 Fall-through : 注释 


在 一 个 switch 块 内 ， 每 个 语句 组 要 么 通过 break, continue, return 或 抛 出 异常 来 终止 ， 要 么 
通过 一 条 注释 来 说 明 程序 将 继续 执行 到 下 一 个 语句 组 ， 任何 能 表达 这 个 意思 的 注释 都 是 OK 的 
(典型 的 是 用 // fall through )。 这 个 特殊 的 注释 并 不 需要 在 最 后 一 个 语句 组 (一 般 

是 default ) 中 出 现 。 示 例 : 


switch (input) { 

case 1: 

case 2: 
prepare0neorTwo(); 
// fall through 

case 3: 
handle0neTwo0rThree(); 
break; 

default: 
handleLargeNumber (input); 


4.8.4.3 default 的 情况 要 写 出 来 


每 个 switch 语 句 都 包含 一 个 default 语句 组 ， 即 使 它 什 么 代码 也 不 包含 。 


4.8.5 注解 (Annotations) 


注解 紧 跟 在 文档 块 后 面 ， 应 用 于 类 、 方法 和 构造 本 数 ， 一 个 注解 独占 一 行 。 这 些 换行 不 属于 
自动 换行 (第 4.5 节 ， 自 动 换行 )， 因 此 缩 进 级 别 不 变 。 例 如 : 


@Override 
@Nullable 
public String getNamelfPresent() { ... } 


例外 : 单个 的 注解 可 以 和 签名 的 第 一 行 出 现在 同一 行 。 例 如 : 


@Override public int hashCode() { ... } 


应 用 于 字段 的 注解 紧 随 文档 块 出 现 ， 应 用 于 字段 的 多 个 注解 允许 与 字段 出 现在 同一 行 。 例 
如 : 


@Partial @Mock DataLoader loader; 


参数 和 局 部 变量 注解 没有 特定 规则 。 


4.8.6 注释 
4.8.6.1 块 注释 风格 


块 注释 与 其 周围 的 代码 在 同一 缩 进 级 别 。 它 们 可 以 是 /* ... */ 风格 ， 也 可 以 是 // ... JA 
格 。 对 于 多 行 的 /* ...*/ 注释 ， 后 续 行 必须 从 * 开始 ， 并 且 和 与 前 一 行 的 * 对 齐 。 以 下 示例 
注释 都 是 OK 的 。 


* This is // And so /* Or you can 
* okay. // is this. * even do this. */ 
S7 


注释 不 要 封闭 在 由 星 号 或 其 它 字 符 绘 制 的 框架 里 。 


Tip : 在 写 多 行 注释 时 ， 如 果 你 希望 在 必要 时 能 重新 换行 ( 即 注释 像 段落 风格 一 样 )， 
BARANDA. 


4.8.7 Modifiers 
类 和 成 员 的 modifiers 如 果 存 在 ， 则 按 Java 语 言 规范 中 推荐 的 顺序 出 现 。 


public protected private abstract static final transient volatile synchronized native str 


图 








5.1 对 所 有 标识 符 都 通用 的 规则 
标识 符 只 能 使 用 ASCIl 字 母 和 数字 ， 因 此 每 个 有 效 的 标识 符 名 称 都 能 匹配 正则 表达 式 Ww 。 


在 Google 其 它 编程 语言 风格 中 使 用 的 特殊 前 级 或 后 级 ， 如 name_ , mName, 
s_name 和 kName ， 在 Java 编 程 风 格 中 都 不 再 使 用 。 


5.2 标识 符 类 型 的 规则 


5.2.1 0% 


包 名 全 部 小 写 ， 连 续 的 单词 只 是 简单 地 连接 起 来 ， 不 使 用 下 划 线 。 


5.2.2 类 名 
类 名 都 以 uppercamelcase 风格 编写 。 


类 名 通常 是 名 词 或 名 词 短 语 ， 接 口 名 称 有 时 可 能 是 形容 词 或 形 
规则 或 行 之 有 效 的 约定 来 命名 注解 类 型 。 


测试 类 的 命名 以 它 要 测试 的 类 的 名 称 开始 ， 以 Test 结束 。 例 


如 ， HashTest 或 HashIntegrationTest o 


容 词 短语 。 


5.2.3 方法 名 


方法 名 都 以 lowercamelcase 风格 编写 。 
方法 名 通常 是 动词 或 动词 短语 。 


下 划 线 可 能 出 现在 JUnit 测 试 方法 名 称 中 用 以 分 隔 名 称 的 逻辑 组 件 。 一 个 典型 的 模式 
是 : test<MethodUnderTest>_<state> , 例如 testPop_emptyStack o 并 不 存在 唯一 正确 的 方式 
来 命名 测试 方法 。 


5.2.4 常量 名 


常量 名 命名 模式 为 coNSTANT_cASE ， 全 部 字母 大 写 ， 用 下 划 线 分 隔 单词 。 那 ， 到 底 什 么 算是 一 
个 常量 ? 


每 个 常量 都 是 一 个 静态 final 字 段 ， 但 不 是 所 有 静态 final 字 段 都 是 常量 。 在 决定 一 个 字段 是 否 是 
一 个 常量 时 ， 考虑 它 是 否 真 的 感觉 像 是 一 个 常量 。 例 如 ， 如 果 任 何 一 个 该 实例 的 观测 状态 是 
可 变 的 ， 则 Eo 定 不 会 是 一 个 常量 。 只 是 永远 不 打算 改变 对 象 一 般 是 不 够 的 ， 它 要 真 的 


// Constants 

static final int NUMBER = 5; 

static final ImmutableList<String> NAMES = ImmutableList.of("Ed", "Ann"); 

static final Joiner COMMA_JOINER = Joiner.on(','); // because Joiner is immutable 
static final SomeMutableType[] EMPTY_ARRAY O; 

enum SomeEnum { ENUM_CONSTANT } 


// Not constants 

static String nonFinal = "non-final"; 

final String nonStatic = "non-static"; 

static final Set<String> mutableCollection = new HashSet<String>(); 

static final ImmutableSet<SomeMutableType> mutableElements = ImmutableSet.of(mutable); 
static final Logger logger = Logger .getLogger(MyClass.getName()); 

static final String[] nonEmptyArray = ("these", "can", "change"); 


Sý 
| 长 


名 字 通 常 是 名 词 或 名 词 短 语 。 


525 非常 量 宇 段 名 


名 以 lowercamelcase 风格 编写 
通常 是 名 词 或 名 词 短 语 。 


5.2.6 参数 名 


参数 名 以 lowercamelcase 风格 编写 。 


参数 应 该 避免 用 单个 字符 命名 。 


5.2.7 局 部 变量 名 


局 部 变量 名 以 lowercamelcase 风格 编写 ， 比 起 其 它 类 型 的 名 称 ， 局 部 变量 名 可 以 有 更 为 宽松 
的 缩写 。 


虽然 缩写 更 宽松 但 还 是 要 避免 用 单字 符 进 行 命名 ， 除 了 临时 变量 和 循环 变量 。 


即使 局 部 变量 是 final 和 不 可 改变 的 ， 也 不 应 该 把 它 示 为 常量 ， 自 然 也 不 能 用 常量 的 规则 去 命名 


它 。 


5.2.8 类 型 变量 名 
类 型 变量 可 用 以 下 两 种 风格 之 一 进行 命名 : 


。 单个 的 大 写字 母 ， 后 面 可 以 跟 一 个 数字 (如 : E, T, X, T2) 
e 以 类 命名 方式 (5.2.2 节 )， 后 面 加 个 大 写 的 T( 如 : RequestT, FooBarT). 


5.3 驼峰 式 命 名 法 (CamelCase) 


驼峰 式 命名 法 分 大 驼峰 式 命 名 法 ( uppercamelcase ) 和 小 驼峰 式 命 名 法 ( lowercamelcase )。 有 
时 ， 我 们 有 不 只 一 种 合理 的 方式 将 一 个 英语 词组 转换 成 驼峰 形式 ， 如 缩 略语 或 不 寻常 的 结构 
(例如 "IPv6" 或 "OS")。Google 指 定 了 以 下 的 转换 方案 。 


AFM 散文 形式 (prose form) 开 始 : 


1. 把 短语 转换 为 纯 ASCIIl 码 ， 并 且 移 除 任何 单 引号 。 例 如 : "Múller's algorithm" 2 
成 "Muellers algorithm"。 
2. 把 这 个 结果 切 分 成 单词 ， 在 空格 或 其 它 标点 符号 (通常 是 连 字符 ) 久 分 割 开 。 
推荐 : 如 果 某 个 单词 已 经 有 了 常用 的 驼峰 表示 形式 ， 按 它 的 组 成 将 它 分 割 开 
(如 "AdWords" 将 分 割 成 "ad words"). 需要 注意 的 是 "iOS" 并 不 是 一 个 真正 的 驼峰 表示 
形式 ， 因 此 该 推荐 对 它 并 不 适用 。 
3. 现在 将 所 有 字母 都 小 写 (包括 缩写 )， 然 后 将 单词 的 第 一 个 字母 大 写 : 
o 每 个 单词 的 第 一 个 字母 都 大 写 ， 来 得 到 大 驼峰 式 命名 。 
o 除了 第 一 个 单词 ， 每 个 单词 的 第 一 个 字母 都 大 写 ， 来 得 到 小 驼峰 式 命名 。 
4. 最 后 将 所 有 的 单词 连接 起 来 得 到 一 个 标识 符 。 


示例 : 
Prose form Correct Incorrect 
"XML HTTP request" Xml1HttpRequest XMLHTTPRequest 
"new customer ID" newCustomer Id newCustomerID 
"inner stopwatch" innerStopwatch innerStopwWatch 
"supports IPv6 on i0S?" supportsIpv60nlos supportsIPv60nI0OS 
"YouTube importer" YouTubelmporter 


Youtubelmporter* 


加 星 号 处 表示 可 以 ， 但 不 推荐 。 


Note : 在 英语 中 ， 某 些 带 有 连 字符 的 单词 形式 不 唯一 。 例 如 : "nonempty" 和 "non- 
empty" 都 是 正确 的 ， 因 此 方法 名 checkNonempty 和 checkNonEmpty 也 都 是 正确 的 。 



































编程 实践 


6.1 @Override : 能 用 则 用 


只 要 是 合法 的 ， 就 把 @override 注解 给 用 上 。 


6.2 捕获 的 异 背 : 不 能 忽视 


除了 下 面 的 例子 ， 对 捕获 的 异常 不 做 响应 是 极 少 正确 的 。( 典 型 的 响应 方式 是 打印 日 志 ， 或 者 
如 果 它 被 认为 是 不 可 能 的 ， 则 把 它 当 作 一 个 AssertionError 重新 抛 出 。) 


如 果 它 确实 是 不 需要 在 catch 块 中 做 任何 响应 ， 需 要 做 注释 加 以 说 明 ( 如 下 面 的 例子 )。 


try £ 
int i = Integer.parselnt(response); 
return handleNumericResponse(i); 
} catch (NumberFormatException ok) { 
// it's not numeric; that's fine, just continue 


} 


return handleTextResponse(response); 


例外 : 在 测试 中 ， 如 果 一 个 捕获 的 异常 被 命名 为 expected ， 则 它 可 以 被 不 加 注释 地 忽略 。 下 
面 是 一 种 非常 常见 的 情形 ， 用 以 确保 所 测试 的 方法 会 抛 出 一 个 期 望 中 的 异常 ， 因此 在 这 里 就 
没有 必要 加 注释 。 


try £ 

emptyStack.pop(); 

fail(); 
} catch (NoSuchElementException expected) { 
} 


63 静态 成 员 : 使 用 类 进行 调用 
使 用 类 名 调用 静态 的 关 成 员 ， 而 不 是 具体 某 个 对 象 或 表达 式 。 


Foo aFoo = ...; 

Foo.aStaticMethod(); // good 

aFoo.aStaticMethod(); // bad 
somethingThatYieldsAFoo().aStaticMethod(); // very bad 


Google Java 编程 规范 (中 文 版 ) 


6.4 Finalizers: 禁 


极 少 会 去 重 载 object.finalize o 


Tip: 不 要 使 用 finalize。 如 果 你 非 要 使 用 它 ， 请 先 仔细 阅读 和 理解 Effective Java 第 7 
条 款 : “Avoid Finalizers”， 然 后 不 要 使 用 它 。 


Finalizers: 禁 
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Javadoc 


7.1 格式 


7.1.1 一 般 形 式 
Javadoc 块 的 基本 格式 如 下 所 示 : 


y. 
* Multiple lines of Javadoc text are written here, 
* wrapped normally... 

7 
public int method(String p1) { ... ) 


或 者 是 以 下 单行 形式 : 


/** An especially short bit of Javadoc. */ 


基本 格式 总 是 OK 的 。 当 整个 Javadoc 块 能 容纳 于 一 行 时 ( 且 没 有 Javadoc 标 记 @XXX)， 可 以 使 
用 单行 形式 。 


7.1.2 段落 


空 行 ( 即 ， 只 包含 最 左 侧 星 号 的 行 ) 会 出 现在 段落 之 间 和 Javadoc 标 记 (@XXX) 之 前 (如 果 有 的 
话 )。 除了 第 一 个 段落 ， 每 个 段落 第 一 个 单词 前 都 有 标签 <p> ， 并 且 它 和 第 一 个 单词 间 没 有 空 


o 


ES 


7.1.3 Javadoc 标 记 


标准 的 Javadoc 标 记 按 以 下 顺序 出 现 : @param ，@return , @throws , @deprecated , 前 面 这 4 
种 标记 如 果 出 现 ， 描 述 都 不 能 为 空 。 当 描述 无 法 在 一 行 中 容纳 ， 连 续 行 需要 至 少 再 缩 进 4 个 
格 。 


7.2 摘要 片段 


每 个 类 或 成 员 的 Javadoc 以 一 个 简短 的 摘要 片段 开始 。 这 个 片段 是 非常 重要 的 ， 在 某 些 情况 
下 ， 它 是 唯一 出 现 的 文本 ， 上 比如 在 类 和 方法 索引 中 。 


这 只 是 一 个 小 片段 ， 可 以 是 一 个 名 词 短 语 或 动词 短语 ， 但 不 是 一 个 完整 的 句子 。 它 不 会 以 A 
{Q@code Foo} is a... 或 This method returns... Fk, 它 也 不 会 是 一 个 完整 的 祈 使 句 ， 如 Save 
the record... o 然而 ， 由 于 开头 大 写 及 被 加 了 标点 ， 它 看 起 来 就 像 是 个 完整 的 句子 。 


Tip: 一 个 常见 的 错误 是 把 简单 的 Javadoc 写 成 /** @return the customer ID */ ， 这 


是 不 正确 的 。 它 应 该 写成 /** Returns the customer ID. */ o 

















7.3 哪里 需要 使 用 Javadoc 


至 少 在 每 个 public 类 及 它 的 每 个 public 和 protected 成 员外 使 用 Javadoc， 以 下 是 一 些 例外 : 


7.3.1 例外 : 不 言 自 明 的 方法 


对 于 简单 明显 的 方法 如 getFoo ，Javadoc 是 可 选 的 ( 即 ， 是 可 以 不 写 的 )。 这 种 情况 下 除了 
“Returns the foo"， 确 实 也 没有 什么 值得 写 了 。 


单元 测试 类 中 的 测试 方法 可 能 是 不 言 自明 的 最 常见 例子 了 ， 我 们 通常 可 以 从 这 些 方法 的 描述 
性 命名 中 知道 它 是 干什么 的 ， 因 此 不 需要 额外 的 文档 说 明 。 
Tip : 如 果 有 一 些 相关 信息 是 需要 读者 了 解 的 ， 那 么 以 上 的 例外 不 应 作为 忽视 这 些 信 


息 的 理由 。 例 如 ， 对 于 方法 名 getcanonicalName ， 就 不 应 该 忽视 文档 说 明 ， 因 为 读 
者 很 可 能 不 知道 词语 canonical name 指 的 是 什么 。 





7.32 例外 : EX 


如 果 一 个 方法 重 载 了 超 类 中 的 方法 ， 那 么 Javadoc 并 非 必 需 的 。 


7.3.3 可 选 的 Javadoc 


对 于 包 外 不 可 见 的 类 和 方法 ， 如 有 需要 ， 也 是 要 使 用 Javadoc 的 。 如 果 一 个 注释 是 用 来 定义 一 
个 类 ， 方 法 ， 字 段 的 整体 目的 或 行为 ， 那么 这 个 注释 应 该 写成 Javadoc， 这 样 更 统一 更 友 
好 。 


